============================================================
MANIFEST.txt — FurryOS / AnthrOS
FINAL CANONICAL SPECIFICATION
============================================================

OWNER & LEGAL
------------------------------------------------------------

Project Name:
FurryOS

Media Layer:
AnthrOS

Owner:
Anthro Entertainment LLC

DBA:
Anthro Entertainment (since 2019)

Trademark:
AnthroHeart™ — Common-Law Trademark (registration pending)

License:
MIT License

Copyright:
(c) 2019–2025 Anthro Entertainment LLC

Trademark Notice:
Trademark rights are NOT granted by the MIT License.

Website:
https://anthroentertainment.com

Donate:
https://donate.anthroentertainment.com

Foundation:
Built on Debian 12 (Bookworm) Foundation

============================================================
POSITIONING & PHILOSOPHY
============================================================

FurryOS is a creative-first, calm, human-friendly operating system.

It is NOT anti-Windows.
It is a friendly companion OS for those who want:
- privacy
- calm
- stability
- offline capability
- zero spyware
- creative freedom

It is NOT just for furries.
It is designed for:
- artists
- musicians
- writers
- developers
- archivists
- seniors / non-technical users (“granny usable”)

AnthrOS is the Media & Metadata Layer that sits above FurryOS.

Core principles:
- boring is good
- obvious over clever
- no black boxes
- no ideology wars
- user control always wins

============================================================
SYSTEM SCOPE
============================================================

Supported environments:
- Bare metal installs
- Virtual machines (VirtualBox, VMware, QEMU/KVM)
- Live boot (try before install)
- Air-gapped systems
- Apocalypse / paranoid scenarios

Hardware:
- Low-end systems (2 GB RAM)
- High-end systems (64 GB+ RAM, GPU)
- HDD and SSD

Firmware policy:
- No Secure Boot enforcement
- No TPM requirements
- No BIOS hardening by default
- No advanced CPU register tuning
- Users may add advanced security later

============================================================
BOOT MODEL
============================================================

Boot flow:
- ALWAYS boot into Live Mode first

Live Mode presents:
[ Try FurryOS (Live) ]
[ Install FurryOS ]

Live Mode:
- Fully functional desktop
- No persistence unless installed
- Networking optional
- Asset library usable
- All system modes available

Installer:
- Install as only OS
- Install alongside Windows
- Install inside VM disk

Bootloader:
- GRUB used internally for compatibility
- GRUB hidden by default
- Instant boot when FurryOS is sole OS
- GRUB menu appears only if:
  - Shift (BIOS)
  - Esc (UEFI)
- Windows dual-boot supported
- macOS dual-boot NOT supported or advertised

============================================================
USER & PRIVILEGE MODEL
============================================================

Accounts:

1) root
- UID 0
- Untouchable system account
- No desktop login
- No SSH login
- Used only for recovery
- Default password: root
- User may change later

2) anthro
- Visible system administrator
- Used for:
  - OS setup
  - maintenance
  - upgrades
- NOT the daily user
- Full sudo privileges
- Default password: anthro

3) Daily User
- MUST be created on first boot after install
- Exactly ONE daily user by default
- This is the normal working account
- No admin rights by default
- May opt-in to sudo later

============================================================
FILESYSTEM & UX MODEL
============================================================

User-facing “world root”:

/TOP/ANTHROHEART/ANTHRO/FurryOS/ROOT

Rules:
- Visible to users
- Editable
- Users can put anything anywhere under it
- This is where people live and work

The actual filesystem root “/” exists but is treated as plumbing
and hidden from normal workflows.

============================================================
LANGUAGE & BUILD MODEL
============================================================

Primary implementation language:
- C++20 (or newer if supported)

Compiler:
- Clang / LLVM ONLY

C++ requirements:
- Single-file .cpp programs
- One tool = one .cpp file
- No Makefiles
- No CMake / Meson / autotools
- No external linked libraries
- C++ standard library ONLY
- No custom include paths
- Compile with:
  clang++ -std=c++20 -O3 tool.cpp -o tool

Secondary:
- POSIX shell (bash) only for orchestration
- Python avoided wherever possible

============================================================
PYTHON POLICY (NO PAIN)
============================================================

Python must “just work”.

Rules:
- Virtual environments are ALLOWED but NEVER REQUIRED
- No PEP 668 “externally-managed environment” errors shown
- pip must always work
- pipx preferred for CLI tools when applicable
- pip used for libraries when needed

System behavior:
- Latest Python is default
- python, python3, pip resolve correctly
- PATH automatically includes:
  /usr/local/bin
  /usr/bin
  /bin
  $HOME/.local/bin
  /opt/furryos/bin

Optional VENV:
- Exists at /opt/furryos/venv
- Never auto-activated
- Used only if user chooses

Python-to-binary:
- Allowed
- Prefer Nuitka
- No GUI form frameworks required

============================================================
NETWORKING POLICY
============================================================

Connection priority (highest to lowest):
1. Ethernet
2. Phone USB tethering
3. Wi-Fi 6 GHz
4. Wi-Fi 5 GHz
5. Wi-Fi 2.4 GHz

Rules:
- NetworkManager used
- No WPS
- No enterprise Wi-Fi (EAP/RADIUS)
- WPA2-Personal default
- WPA3-Personal optional
- Hidden SSIDs supported
- MAC randomization OFF
- Stable device identity
- Prefer least-congested AP
- Avoid network flapping

============================================================
SYSTEM MODES (ONE PLACE)
============================================================

All modes live in ONE control panel.

Modes:

Balanced (default)
- Calm
- Stable
- Efficient

Performance
- Max CPU
- Max disk throughput
- Minimal background activity

Fun
- Multimedia-first layout
- Asset library front and center
- Music, images, video visible

Paranoid
- Internet kill-switch
- No background network
- Offline-first
- Reduced attack surface

============================================================
BANDWIDTH & OPTIMIZATION
============================================================

Optimization is OPT-IN.

When enabled:
- System adapts automatically based on:
  - RAM
  - CPU
  - disk type
  - internet speed
  - number of people sharing connection

Internet presets:
- Slow / Metered (56k–DSL)
- Normal
- Fast / Fiber

Slow mode:
- Aggressive compression
- Efficient codecs
- Reduced media bitrates
- Readability prioritized

Fast mode:
- Minimal compression
- Full-quality visuals
- Avoid pointless caching

============================================================
ASSET LIBRARY (CORE FEATURE)
============================================================

AnthrOS Asset Library is CORE.

Default example path:
/TOP/ANTHROHEART/ANTHRO/FurryOS/ROOT/ASSETS

Requirements:
- Recursive scan of ALL subfolders
- Case-insensitive
- Read-only (never modify files)
- Handles large libraries (GB–TB)

Metadata collected:
- Filename
- Full path
- File size
- Extension
- MIME type (if determinable)
- Category:
  image / audio / video / archive / other

Output:
- JSON index
- Human-readable summary optional
- No databases

System must function if:
- Asset folder is empty
- Assets added later
- System is offline

============================================================
SPLASH SCREEN & AUDIO
============================================================

Optional, user-toggleable.

If enabled:
- Splash shows:
  “FurryOS”
  “Licensed (MIT) by Anthro Entertainment LLC”
  “It’s not just for Furries!”

- On boot:
  - Random image from asset library
  - Play 5 seconds of random WAV or MP3
- On shutdown:
  - Play 5 seconds of random audio

Silent fallback if assets missing.

============================================================
SECURITY & ENCRYPTION
============================================================

No spyware.
No telemetry by default.

Full disk encryption:
- Optional
- Uses VeraCrypt
- No TPM
- No cloud recovery keys

Password management:
- KeePassXC recommended
- Offline only
- No accounts

Secrets:
- Stored as environment variables
- Simple GUI dialog to paste keys
- No cloud sync

============================================================
TELEMETRY MODEL
============================================================

Telemetry is OPT-IN.

Choices:
( ) No Telemetry (default)
( ) Max Telemetry (local-only)

Max Telemetry behavior:
- Writes anonymous system metrics to plain text file
- NEVER uploads
- User may share manually later

Telemetry file example:
 /TOP/ANTHROHEART/ANTHRO/FurryOS/ROOT/telemetry/furryos-telemetry.txt

Never collected:
- Browsing history
- URLs
- Files
- Filenames
- Media content
- Passwords
- API keys
- IP addresses
- Location

============================================================
BUILD-TIME AI POLICY
============================================================

AI is allowed ONLY during build.

Rules:
- AI is NOT baked into FurryOS
- No API keys shipped
- No runtime AI
- No background AI

Builder behavior:
- Reads OpenAI_Key.txt if present
- Uses AI only for build heuristics
- Works offline without AI

Models:
- Default: lightweight model (4o-mini equivalent)
- Optional: full reasoning model (GPT-5.x class)

Final output contains ZERO AI components.

============================================================
DELIVERABLES
============================================================

- ONE C++20 builder source file
- This MANIFEST.txt
- Output: FurryOS ISO

No other source files required.

============================================================
END OF MANIFEST
============================================================

